中文 | English

适用于 Claude Code 的 Codex 插件

在 Claude Code 内部调用 Codex，进行代码审查，或者把任务委派给 Codex。

这个插件面向已经在使用 Claude Code、但希望直接从当前工作流开始使用 Codex 的用户。

你能获得什么

• /codex:review：标准只读 Codex review
• /codex:adversarial-review：可定向挑战某个方案的 review
• /codex:rescue、/codex:status、/codex:result 与 /codex:cancel：用于委派工作并管理后台任务

要求

• ChatGPT 订阅（含 Free）或 OpenAI API key。
  • 使用会计入你的 Codex usage limits。了解更多。
• Node.js 18.18 或更高版本

安装

先在 Claude Code 中添加 marketplace：

/plugin marketplace add openai/codex-plugin-cc

安装插件：

/plugin install codex@openai-codex

重新加载插件：

/reload-plugins

然后运行：

/codex:setup

/codex:setup 会告诉你 Codex 是否已经就绪。如果系统中还没有 Codex 且可以使用 npm，它会提示你是否要自动安装 Codex。

如果你更愿意自己安装 Codex，可以运行：

npm install -g @openai/codex

如果 Codex 已安装但还没有登录，运行：

!codex login

安装完成后，你应该能看到：

• 下文列出的 slash commands
• /agents 中的 codex:codex-rescue subagent

一个简单的首次运行方式是：

/codex:review --background
/codex:status
/codex:result

用法

/codex:review

对当前工作运行标准 Codex review。它提供的代码审查质量，与直接在 Codex 里运行 /review 相同。

Note

代码审查，尤其是多文件改动的审查，可能会花比较久。通常建议把它放到后台运行。

适用场景：

• 审查当前尚未提交的改动
• 审查当前分支相对某个 base branch（如 main）的差异

可用 --base <ref> 做分支审查，也支持 --wait 和 --background。它不可定向，不接受自定义 focus text。如果你想挑战某个具体决策或风险区域，请使用 /codex:adversarial-review。

示例：

/codex:review
/codex:review --base main
/codex:review --background

这个命令是只读的，不会执行任何修改。若在后台运行，可以用 /codex:status 查看进度，并用 /codex:cancel 取消正在进行的任务。

/codex:adversarial-review

运行一种可定向的 review，用来质疑当前实现和设计选择。

它可用于对假设、权衡、故障模式，以及“是否本该采用更安全或更简单的方案”进行压力测试。

它与 /codex:review 使用相同的审查目标选择机制，包括用 --base <ref> 做分支审查，也同样支持 --wait 和 --background。与 /codex:review 不同的是，它可以在参数后额外接收 focus text。

适用场景：

• 在上线前做一次挑战方向本身而不只是代码细节的审查
• 把审查重点放在设计选择、权衡、隐藏假设和替代方案上
• 围绕 auth、数据丢失、回滚、竞态条件或可靠性等特定风险区域做压力测试

示例：

/codex:adversarial-review
/codex:adversarial-review --base main challenge whether this was the right caching and retry design
/codex:adversarial-review --background look for race conditions and question the chosen approach

这个命令是只读的，不会修代码。

/codex:rescue

通过 codex:codex-rescue subagent 把任务交给 Codex。

适用场景是希望 Codex：

• 调查一个 bug
• 尝试修复
• 延续之前某个 Codex 任务
• 用更小模型做一次更快或更便宜的尝试

Note

取决于任务和所选模型，这些任务可能需要很久，通常建议强制放后台，或把 agent 移到后台。

它支持 --background、--wait、--resume 和 --fresh。如果你没有传 --resume 或 --fresh，插件可以提示你继续这个仓库里最近一次 rescue thread。

示例：

/codex:rescue investigate why the tests started failing
/codex:rescue fix the failing test with the smallest safe patch
/codex:rescue --resume apply the top fix from the last run
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test
/codex:rescue --model spark fix the issue quickly
/codex:rescue --background investigate the regression

你也可以直接用自然语言要求把任务委派给 Codex：

Ask Codex to redesign the database connection to be more resilient.

说明：

• 如果你没有传 --model 或 --effort，Codex 会自己选择默认值。
• 如果你写的是 spark，插件会把它映射到 gpt-5.3-codex-spark
• 后续 rescue 请求可以继续这个仓库里最近一次 Codex 任务

/codex:status

显示当前仓库里正在运行和最近完成的 Codex jobs。

示例：

/codex:status
/codex:status task-abc123

用途：

• 查看后台任务进度
• 查看最近完成的任务
• 确认某个任务是否仍在运行

/codex:result

显示某个已完成任务最终保存下来的 Codex 输出。如果可用，还会包含 Codex session ID，这样你可以直接在 Codex 中用 codex resume <session-id> 重新打开该运行。

示例：

/codex:result
/codex:result task-abc123

/codex:cancel

取消一个正在运行的后台 Codex 任务。

示例：

/codex:cancel
/codex:cancel task-abc123

/codex:setup

检查 Codex 是否已经安装并完成认证。如果系统中还没有 Codex 且可以使用 npm，它会提示是否安装 Codex。

你也可以通过 /codex:setup 管理可选的 review gate。

启用 review gate

/codex:setup --enable-review-gate
/codex:setup --disable-review-gate

启用 review gate 后，插件会使用一个 Stop hook，基于 Claude 的响应触发一次定向 Codex review。如果这次 review 找到问题，就会阻止 stop，让 Claude 先处理这些问题。

Warning

review gate 可能会形成一个长时运行的 Claude/Codex loop，并快速消耗 usage limits。只有在你准备主动监控当前会话时才应启用。

典型流程

上线前做 review

/codex:review

把问题交给 Codex

/codex:rescue investigate why the build is failing in CI

启动一个长时任务

/codex:adversarial-review --background
/codex:rescue --background investigate the flaky test

然后通过下面这些命令回来看结果：

/codex:status
/codex:result

Codex 集成方式

这个 Codex 插件封装了 Codex app server。它使用你环境里全局安装的 codex 二进制，并且沿用同一套配置。

常见配置

如果你想修改插件默认使用的 reasoning effort 或模型，可以在用户级或项目级 config.toml 里定义。比如，如果你希望某个项目始终使用 gpt-5.4-mini 和 high，可以在你启动 Claude 的目录根部创建 .codex/config.toml 并写入：

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

配置会按照以下层级生效：

• 用户级配置 ~/.codex/config.toml
• 项目级覆盖 .codex/config.toml
• 项目级覆盖只有在项目被标记为 trusted时才会加载

更多配置项请查看 Codex 文档中的配置选项。

把工作切换到 Codex 里继续

被委派的任务，以及任何 stop gate 触发的运行，都可以通过 codex resume 直接在 Codex 中继续。你既可以传 /codex:result 或 /codex:status 返回的具体 session ID，也可以从列表中选择。

这样你既可以在 Codex 中继续工作，也可以回头审查 Codex 的输出。

FAQ

这个插件需要单独的 Codex 账号吗？

如果你已经在这台机器上登录过 Codex，那么同一个账号应该可以直接在这里使用。这个插件沿用的是你本地 Codex CLI 的认证状态。

如果你现在只用 Claude Code、还没有用过 Codex，那么你还需要用 ChatGPT 账号或 API key 登录 Codex。ChatGPT 订阅已包含 Codex，而且 codex login 同时支持 ChatGPT 和 API key 登录。运行 /codex:setup 可以检查 Codex 是否就绪；如果没有，就用 !codex login。

这个插件会使用一个独立的 Codex runtime 吗？

不会。这个插件通过你本地机器上的 Codex CLI 和 Codex app server 来委派工作。

这意味着：

• 它使用的就是你平时直接使用的同一个 Codex 安装
• 它使用的是同一份本地认证状态
• 它使用的是同一个仓库 checkout 和机器本地环境

它会沿用我已有的 Codex 配置吗？

会。如果你已经在使用 Codex，这个插件会读取同一套配置。

我可以继续使用现有的 API key 或 base URL 配置吗？

可以。因为插件使用的是你本地 Codex CLI，所以你现有的登录方式和配置同样适用。

如果你需要把内建 OpenAI provider 指向另一个 endpoint，请在 Codex 配置 中设置 openai_base_url。